Release 10.1A: OpenEdge Development:
Programming Interfaces

SAX-reader object

The application creates a SAX-reader object and uses it to control the XML parser.

The application can parse an XML document in one call or in multiple calls. For more information on this, see the "Parsing with one call or with multiple calls" section.

When the application is finished parsing the XML document, it is important to delete the SAX-reader object.

The attributes and methods associated with the SAX-reader object are summarized in Table 20–1. For reference entries, see the OpenEdge Development: Progress 4GL Reference .

Table 20–1: SAX-reader attribute and method summary

This attribute or method...	Lets you...
SET-INPUT-SOURCE() method	Specify the XML input.
SCHEMA-PATH attribute	Specify a search path for the Document Type Definition (DTD) or any other external entities.
SCHEMA-LOCATION attribute ADD-SCHEMA-LOCATION( ) method	The SCHEMA-LOCATION attribute contains a whitespace separated list of namespace schema location pairs. The method allows you to add another pair to the attribute’s list. Each XML schema specified will be used to validate XML elements with matching namespaces.
NONAMESPACE-SCHEMA-LOCATION attribute	Contains the single namespace schema location pair. The XML schema specified will be used to validate XML elements that do not specify a namespace.
HANDLER attribute	Tell the parser where the callbacks reside.
SUPPRESS-NAMESPACE-PROCESSING attribute VALIDATION-ENABLED attribute	Toggle parser options.
SAX-PARSE() method SAX-PARSE-FIRST() method SAX-PARSE-NEXT() method STOP-PARSING() method	Start, continue, or stop parsing.
LOCATOR-COLUMN-NUMBER attribute LOCATOR-LINE-NUMBER attribute LOCATOR-PUBLIC-ID attribute LOCATOR-SYSTEM-ID attribute PARSE-STATUS attribute	Get the status of the parse.
TYPE attribute	Get the type of the object (which is always “SAX-reader”).
ADM-DATA attribute PRIVATE-DATA attribute UNIQUE-ID attribute	Get or set information concerning this particular SAX-reader object.